Cheatsheets para desarrolladores experimentados de React que estan empezando con TypeScript
Básico | Avanzado | Migrando | HOC | Inglés | 中文翻译 | Contribuir | Preguntas
Este HOC Cheatsheet agrupa todo el conocimiento disponible para escribir Componentes de Orden Superior (HOC por las siglas en inglés de higher-order component) con React y Typescript.
- Inicialmente haremos un mapa detallado de la documentación oficial sobre HOC.
- Si bien existen hooks, muchas librerías y bases de código aún necesitan escribir HOC
- Render props podrian ser considerado en el futuro
- El objetivo es escribir HOC que ofrezcan un tipado seguro sin interferir
Expandir Tabla de Contenido
Este es un ejemplo de un HOC para copiar y pegar. Si ciertos pedazos no tienen sentido para ti, ve a la Sección 1 para obtener un tutorial detallado a través de una traducción completa de la documentación de React en Typescript.
A veces quieres una forma sencilla de pasar props desde otro lugar (ya sea el store global o un provider) y no quieres continuamente pasar los props hacia abajo. Context es excelente para eso, pero entonces los valores desde el context solo pueden ser usado desde tu función render. Un HOC proveerá esos valores cómo props.
Los props inyectados
interface WithThemeProps {
primaryColor: string;
}Uso en el componente
El objetivo es tener los props disponibles en la interfaz para el componente, pero sustraído para los consumidores del componente cuando estén envuelto en el HoC.
interface Props extends WithThemeProps {
children: React.ReactNode;
}
class MyButton extends React.Component<Props> {
public render() {
// Renderiza un elemento usando el tema y otros props.
}
private someInternalMethod() {
// Los valores del tema también estan aquí disponibles cómo props.
}
}
export default withTheme(MyButton);Consumiendo el componente
Ahora, al consumir el componente puedes omitir el prop primaryColor o anular el que fue proporcionado a través del context.
<MyButton>Hello button</MyButton> // Válido
<MyButton primaryColor="#333">Hello Button</MyButton> // Tambien válidoDeclarando el HoC
El HoC actual.
export function withTheme<T extends WithThemeProps = WithThemeProps>(
WrappedComponent: React.ComponentType<T>
) {
// Intenta crear un buen displayName para React Dev Tools.
const displayName =
WrappedComponent.displayName || WrappedComponent.name || "Component";
// Creando el componente interno. El tipo de prop calculado aquí es donde ocurre la magia.
return class ComponentWithTheme extends React.Component<
Optionalize<T, WithThemeProps>
> {
public static displayName = `withPages(${displayName})`;
public render() {
// Obten los props que quiere inyectar. Esto podría ser hecho con context.
const themeProps = getThemePropsFromSomeWhere();
// this.props viene después para que puedan anular los props predeterminados.
return <WrappedComponent {...themeProps} {...(this.props as T)} />;
}
};
}Tenga en cuenta que la aserción {...this.props as T} es necesaria debido a un error en TS 3.2 microsoft/TypeScript#28938 (comment)
Para obtener detalles de Optionalize consulte la sección de tipos de utilidad
Aquí hay un ejemplo más avanzado de un Componente Dinámico de Orden Superior (HOC por las siglas en inglés de higher-order component) que basa algunos de sus parámetros en los props del componente que está siendo pasado.
// Inyecta valores estáticos a un componente de tal manera que siempre son proporcionados.
export function inject<TProps, TInjectedKeys extends keyof TProps>(
Component: React.JSXElementConstructor<TProps>,
injector: Pick<TProps, TInjectedKeys>
) {
return function Injected(props: Omit<TProps, TInjectedKeys>) {
return <Component {...(props as TProps)} {...injector} />;
};
}Para una reutilización "verdadera", también debes considerar exponer una referencia para tus HOC. Puedes utilizar React.forwardRef<Ref, Props> cómo está documentado en el cheatsheet básico, pero estamos interesados en más ejemplos del mundo real. Aquí hay un buen ejemplo en práctica de @OliverJAsh.
En esta primera sección nos referimos de cerca a la documentación de React sobre HOC y ofrecemos un paralelo directo en TypeScript.
Ejemplo de la documentación: Usa HOCs para preocupaciones transversales
Variables a las que se hace referencia en el siguiente ejemplo
/** Componentes hijos ficticios que pueden recibir cualquiera cosa */
const Comment = (_: any) => null;
const TextBlock = Comment;
/** Data ficticia */
type CommentType = { text: string; id: number };
const comments: CommentType[] = [
{
text: "comment1",
id: 1
},
{
text: "comment2",
id: 2
}
];
const blog = "blogpost";
/** simulación de la data */
const DataSource = {
addChangeListener(e: Function) {
// Hace algo
},
removeChangeListener(e: Function) {
// Hace algo
},
getComments() {
return comments;
},
getBlogPost(id: number) {
return blog;
}
};
/** Escriba alias solo para deduplicar */
type DataType = typeof DataSource;
// type TODO_ANY = any;
/** Tipos de utilidad que utilizamos */
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
// type Optionalize<T extends K, K> = Omit<T, keyof K>;
/** Componentes reescritos de la documentación de React que solo utilizan props inyectados */
function CommentList({ data }: WithDataProps<typeof comments>) {
return (
<div>
{data.map((comment: CommentType) => (
<Comment comment={comment} key={comment.id} />
))}
</div>
);
}
interface BlogPostProps extends WithDataProps<string> {
id: number;
// children: ReactNode;
}
function BlogPost({ data, id }: BlogPostProps) {
return (
<div key={id}>
<TextBlock text={data} />;
</div>
);
}Ejemplo de un HOC de la documentación de React traducido a TypeScript
// Estos son los props que serán inyectados por el HOC
interface WithDataProps<T> {
data: T; // data es genérico
}
// T es el tipo de data
// P son los props del componente envuelto que es inferido
// C es la interfaz real del componente envuelto (utilizado para tomar los defaultProps)
export function withSubscription<T, P extends WithDataProps<T>, C>(
// este tipo nos permite inferir P, pero toma el tipo de componente envuelto por separado sin que interfiera con la inferencia en P
WrappedComponent: React.JSXElementConstructor<P> & C,
// selectData es un functor para T
// los props son solo de lectura porque son solo lectura dentro de la clase
selectData: (
dataSource: typeof DataSource,
props: Readonly<JSX.LibraryManagedAttributes<C, Omit<P, "data">>>
) => T
) {
// the magic is here: JSX.LibraryManagedAttributes will take the type of WrapedComponent and resolve its default props
// against the props of WithData, which is just the original P type with 'data' removed from its requirements
type Props = JSX.LibraryManagedAttributes<C, Omit<P, "data">>;
type State = {
data: T;
};
return class WithData extends React.Component<Props, State> {
constructor(props: Props) {
super(props);
this.handleChange = this.handleChange.bind(this);
this.state = {
data: selectData(DataSource, props)
};
}
componentDidMount = () => DataSource.addChangeListener(this.handleChange);
componentWillUnmount = () =>
DataSource.removeChangeListener(this.handleChange);
handleChange = () =>
this.setState({
data: selectData(DataSource, this.props)
});
render() {
// la escritura para difundir this.props es... muy compleja. La mejor manera de hacerlo ahora mismo es escribirlo cómo `any`
// data todavia sera verificada
return (
<WrappedComponent data={this.state.data} {...(this.props as any)} />
);
}
};
// return WithData;
}
/** Uso de HOC con Componentes */
export const CommentListWithSubscription = withSubscription(
CommentList,
(DataSource: DataType) => DataSource.getComments()
);
export const BlogPostWithSubscription = withSubscription(
BlogPost,
(DataSource: DataType, props: Omit<BlogPostProps, "data">) =>
DataSource.getBlogPost(props.id)
);Ejemplo de documentación: No mutes el componente original. Usa composición.
Es bastante sencillo - asegurate de comprobar los props recibidos cómo T debido al error TS 3.2.
function logProps<T>(WrappedComponent: React.ComponentType<T>) {
return class extends React.Component {
componentWillReceiveProps(
nextProps: React.ComponentProps<typeof WrappedComponent>
) {
console.log("Current props: ", this.props);
console.log("Next props: ", nextProps);
}
render() {
// Envuelve el componente de entrada en un contenedor sin mutarlo. Muy bien!
return <WrappedComponent {...(this.props as T)} />;
}
};
}Ejemplo de la documentación: Pasa los props no relacionados al componente envuelto
No se necesitan consejos específicos de Typescript aquí.
Ejemplo de la documentación: Maximizar la componibilidad
los HOC pueden tomar la forma de funciones que retornan Componentes de Orden Superior que devuelven Componentes
la función connect de react-redux tiene una serie de sobrecargas del que puedes obtener inspiración fuente
Construiremos nuestro propio connect para entender los HOC:
Variables a las que se hace referencia en el siguiente ejemplo:
/** tipos de utilidad que utilizamos */
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
/** datos ficticios */
type CommentType = { text: string; id: number };
const comments: CommentType[] = [
{
text: "comment1",
id: 1
},
{
text: "comment2",
id: 2
}
];
/** componentes ficticios que reciben cualquier cosa */
const Comment = (_: any) => null;
/** Componentes reescritos de la documentación de React que solo utilizan props de datos inyectados **/
function CommentList({ data }: WithSubscriptionProps<typeof comments>) {
return (
<div>
{data.map((comment: CommentType) => (
<Comment comment={comment} key={comment.id} />
))}
</div>
);
}const commentSelector = (_: any, ownProps: any) => ({
id: ownProps.id
});
const commentActions = () => ({
addComment: (str: string) => comments.push({ text: str, id: comments.length })
});
const ConnectedComment = connect(commentSelector, commentActions)(CommentList);
// prop que son inyectadas por el HOC.
interface WithSubscriptionProps<T> {
data: T;
}
function connect(mapStateToProps: Function, mapDispatchToProps: Function) {
return function<T, P extends WithSubscriptionProps<T>, C>(
WrappedComponent: React.ComponentType<T>
) {
type Props = JSX.LibraryManagedAttributes<C, Omit<P, "data">>;
// Creando el componente interno. El tipo de propiedades calculadas, es donde ocurre la magia
return class ComponentWithTheme extends React.Component<Props> {
public render() {
// Obten los props que desea inyectar. Esto podría hacerse con context
const mappedStateProps = mapStateToProps(this.state, this.props);
const mappedDispatchProps = mapDispatchToProps(this.state, this.props);
// this props viene después de tal modo que anula los predeterminados
return (
<WrappedComponent
{...this.props}
{...mappedStateProps}
{...mappedDispatchProps}
/>
);
}
};
};
}Ver en el TypeScript Playground
Ejemplo de la documentación: Envuelve el nombre a mostrar para una depuración fácil
Este es bastante sencillo
interface WithSubscriptionProps {
data: any;
}
function withSubscription<
T extends WithSubscriptionProps = WithSubscriptionProps
>(WrappedComponent: React.ComponentType<T>) {
class WithSubscription extends React.Component {
/* ... */
public static displayName = `WithSubscription(${getDisplayName(
WrappedComponent
)})`;
}
return WithSubscription;
}
function getDisplayName<T>(WrappedComponent: React.ComponentType<T>) {
return WrappedComponent.displayName || WrappedComponent.name || "Component";
}No escrito: sección de consideraciones
- No utilice HOCs dentro del método render
- Los métodos estáticos deben ser copiados
- Las Refs no son pasadas
Esto es cubierto en la sección 1 pero aquí nos centraremos en el ya que es un problema muy común. Los HOC a menudo inyectan props a componentes pre-fabricados. El problema que queremos resolver es que el componente envuelto en HOC exponga un tipo que refleje el área de superficie reducida de los props - sin tener que volver a escribir manualmente el HOC cada vez. Esto implica algunos genericos, afortunadamente con algunas utilidades auxiliares.
Digamos que tenemos un componente
type DogProps {
name: string
owner: string
}
function Dog({name, owner}: DogProps) {
return <div> Woof: {name}, Owner: {owner}</div>
}Y tenemos un HOC withOwner que inyecta el owner:
And we have a withOwner HOC that injects the owner:
const OwnedDog = withOwner("swyx")(Dog);Queremos escribir withOwner de tal modo que pase por los tipos de cualquier componente cómo Dog, en el tipo de OwnedDog, menos la propiedad owner que inyecta:
typeof OwnedDog; // queremos que sea igual a { name: string }
<Dog name="fido" owner="swyx" />; // este debe estar bien
<OwnedDog name="fido" owner="swyx" />; // este debe tener un typeError
<OwnedDog name="fido" />; // este debe estar bien
// y el HOC debe ser reusable por tipos de props totalmente diferentes!
type CatProps = {
lives: number;
owner: string;
};
function Cat({ lives, owner }: CatProps) {
return (
<div>
{" "}
Meow: {lives}, Owner: {owner}
</div>
);
}
const OwnedCat = withOwner("swyx")(Cat);
<Cat lives={9} owner="swyx" />; // este debe estar bien
<OwnedCat lives={9} owner="swyx" />; // este debe tener un typeError
<OwnedCat lives={9} />; // este debe estar bienEntonces, cómo escribimos withOwner?
- Obtenemos los tipos del componente:
keyof T - Nosotros
Excludelas propiedades que queremos encamascarar:Exclude<keyof T, 'owner'>, esto te deje con una lista de nombre de propiedades que quieres en el componente envuelto ejm:name - (Opcional) Utilice los tipo de intersección sí tiene mas para excluir:
Exclude<keyof T, 'owner' | 'otherprop' | 'moreprop'> - Los nombres de las propiedades no son exactamente iguales a las propiedades en sí, los cuales también tienen un tipo asociado. Así que utilizamos esta lista generada de nombre para elegir
Pickde los props originales:Pick<keyof T, Exclude<keyof T, 'owner'>>, this leaves you with the new, filtered props, e.g.{ name: string } - (opcional) En lugar de escribir esto manualmente cada vez, podemos utilizar esta utilidad:
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>> - Ahora escribimos el HOC cómo un función genérica:
function withOwner(owner: string) {
return function<T extends { owner: string }>(
Component: React.ComponentType<T>
) {
return function(props: Omit<T, "owner">): React.ReactNode {
return <Component owner={owner} {...props} />;
};
};
}Nota: el de arriba es un ejemplo incompleto y no funcional. PR una solución!
Tendremos que extraer las lecciones de aquí en el futuro pero aquí estan: