# 富文本

命名空间：`core/rich-text`。

## 选择器

<!-- START TOKEN(Autogenerated selectors|../../../packages/rich-text/src/store/selectors.js) -->

### getFormatType

根据名称返回格式类型。

_用法_

```js
import { __, sprintf } from '@wordpress/i18n';
import { store as richTextStore } from '@wordpress/rich-text';
import { useSelect } from '@wordpress/data';

const ExampleComponent = () => {
   const { getFormatType } = useSelect(
       ( select ) => select( richTextStore ),
       []
   );

   const boldFormat = getFormatType( 'core/bold' );

   return boldFormat ? (
       <ul>
           { Object.entries( boldFormat )?.map( ( [ key, value ] ) => (
               <li>
                   { key } : { value }
               </li>
          ) ) }
      </ul>
   ) : (
       __( 'Not Found' )
   ;
};
```

_参数_

-   _state_ `Object`: 数据状态。
-   _name_ `string`: 格式类型名称。

_返回值_

-   `?Object`: 格式类型。

### getFormatTypeForBareElement

Gets the format type, if any, that can handle a bare element (without a data-format-type attribute), given the tag name of this element.

_Usage_

```js
import { __, sprintf } from '@wordpress/i18n';
import { store as richTextStore } from '@wordpress/rich-text';
import { useSelect } from '@wordpress/data';

const ExampleComponent = () => {
	const { getFormatTypeForBareElement } = useSelect(
		( select ) => select( richTextStore ),
		[]
	);

	const format = getFormatTypeForBareElement( 'strong' );

	return format && <p>{ sprintf( __( 'Format name: %s' ), format.name ) }</p>;
};
```

_Parameters_

-   _state_ `Object`: Data state.
-   _bareElementTagName_ `string`: The tag name of the element to find a format type for.

_Returns_

-   `?Object`: Format type.

### getFormatTypeForClassName

Gets the format type, if any, that can handle an element, given its classes.

_Usage_

```js
import { __, sprintf } from '@wordpress/i18n';
import { store as richTextStore } from '@wordpress/rich-text';
import { useSelect } from '@wordpress/data';

const ExampleComponent = () => {
	const { getFormatTypeForClassName } = useSelect(
		( select ) => select( richTextStore ),
		[]
	);

	const format = getFormatTypeForClassName( 'has-inline-color' );

	return format && <p>{ sprintf( __( 'Format name: %s' ), format.name ) }</p>;
};
```

_Parameters_

-   _state_ `Object`: Data state.
-   _elementClassName_ `string`: The classes of the element to find a format type for.

_Returns_

-   `?Object`: Format type.

### getFormatTypes

返回所有可用的格式类型。

_用法_

```js
import { __, sprintf } from '@wordpress/i18n';
import { store as richTextStore } from '@wordpress/rich-text';
import { useSelect } from '@wordpress/data';

const ExampleComponent = () => {
	const { getFormatTypes } = useSelect(
		( select ) => select( richTextStore ),
		[]
	);

	const availableFormats = getFormatTypes();

	return availableFormats ? (
		<ul>
			{ availableFormats?.map( ( format ) => (
				<li>{ format.name }</li>
			) ) }
		</ul>
	) : (
		__( '无可用格式' )
	);
};
```

_参数_

-   _state_ `Object`: 数据状态。

_返回值_

-   `Array`: 格式类型。

<!-- END TOKEN(Autogenerated selectors|../../../packages/rich-text/src/store/selectors.js) -->

## 操作

<!-- START TOKEN(Autogenerated actions|../../../packages/rich-text/src/store/actions.js) -->

暂无内容可记录。

<!-- END TOKEN(Autogenerated actions|../../../packages/rich-text/src/store/actions.js) -->