分层状态节点 Hierarchical State Node

在状态图中，状态可以嵌套 在其他状态中 。 这些嵌套状态称为 复合状态。 要了解更多信息，请阅读状态图简介中的复合状态部分。

API

以下示例是具有嵌套状态的交通灯状态机：

const pedestrianStates = {
  initial: 'walk',
  states: {
    walk: {
      on: {
        PED_COUNTDOWN: { target: 'wait' }
      }
    },
    wait: {
      on: {
        PED_COUNTDOWN: { target: 'stop' }
      }
    },
    stop: {},
    blinking: {}
  }
};
const lightMachine = createMachine({
  key: 'light',
  initial: 'green',
  states: {
    green: {
      on: {
        TIMER: { target: 'yellow' }
      }
    },
    yellow: {
      on: {
        TIMER: { target: 'red' }
      }
    },
    red: {
      on: {
        TIMER: { target: 'green' }
      },
      ...pedestrianStates
    }
  },
  on: {
    POWER_OUTAGE: { target: '.red.blinking' },
    POWER_RESTORED: { target: '.red' }
  }
});

'green' 和 'yellow' 状态是 简单的状态 ——它们没有子状态。 相比之下，'red' 状态是复合状态，因为它由 子状态（pedestrianStates）组成。

初始状态

当进入复合状态时，它的初始状态也立即进入。 在以下交通灯状态机示例中：

• 'red' 状态已进入
• 由于 'red' 的初始状态为 'walk'，因此最终进入 { red: 'walk' } 状态。

console.log(lightMachine.transition('yellow', { type: 'TIMER' }).value);
// => {
//   red: 'walk'
// }

事件

当前状态不处理 event 时，该 event 将传播到其要处理的父状态。 在以下交通灯状态机示例中：

• { red: 'stop' } 状态 不 处理'TIMER' 事件
• 'TIMER' 事件被发送到处理该事件的 'red' 父状态。

console.log(lightMachine.transition({ red: 'stop' }, { type: 'TIMER' }).value);
// => 'green'

如果状态或其任何祖先（父）状态均未处理事件，则不会发生转换。 在 strict 模式下（在 状态机配置 中指定），这将引发错误。

console.log(lightMachine.transition('green', { type: 'UNKNOWN' }).value);
// => 'green'