H5&小程序开发-React组件流行代码规范

更新日期: 2022-05-07阅读: 825标签: 组件

一、多个 porps 传递到单个组件

表明该组件应该拆分;遇到或者想在这个列表再添加一个组件时

1、该组件能做多少事?

要确认是否可以将组件拆分为多个较小的组件

2、可否合并?

compose components 组成组件,而不只处理一个组件内的所有逻辑

<ApplicationForm
user={userData}
organization={organizationData}
categories={categoriesData}
locations={locationsData}
onSubmit={handleSubmit}
onCancel={handleCancel}
/>

处理后:

<ApplicationForm onSubmit={handleSubmit} onCancel={handleCancel}>
<ApplicationUserForm user={userData} />
<ApplicationOrganizationForm organization={organizationData} />
<ApplicationCategoryForm categories={categoriesData} />
<ApplicationLocationsForm locations={locationsData} />
</ApplicationForm>

3、是否传递了很多配置?

最好是组合成一个对象,除数据

<Grid
data={gridData}
pagination={false}
autoSize={true}
enableSort={true}
sortOrder="desc"
disableSelection={true}
infiniteScroll={true}
/>

处理后:

const options = {
pagination: false,
autoSize: true,
enableSort: true,
sortOrder: 'desc',
disableSelection: true,
infiniteScroll: true,
...
}
<Grid
data={gridData}
options={options}
/>


二、不兼容的 props

避免传递彼此不兼容的的 props, 例:先创建通用 input 组件来处理文本,但还增加处理电话号码:

function Input({ value, isPhoneNumberInput, autoCapitalize }) {
if (autoCapitalize) capitalize(value);

return <input value={value} type={isPhoneNumberInput ? "tel" : "text"} />;
}

后两个不能同时使用,电话号码无法大写,所以需要将组件分解成多个小组件,让一些逻辑可以它们之间共享

function TextInput({ value, autoCapitalize }) {
if (autoCapitalize) capitalize(value);
useSharedInputLogic();

return <input value={value} type="text" />;
}

function PhoneNumberInput({ value }) {
useSharedInputLogic();

return <input value={value} type="tel" />;
}


三、复制 props 到 state

不要通过将 props 复制到 state 来 停止数据流

function Button({ text }) {
const [buttonText] = useState(text);

return <button>{buttonText}</button>;
}

通过将 text prop 作为 useState 的初始值传递,实际上忽略了 text 的所有更新值。 若 text prop 更新,组件将 render 其第一个值
下面更实际的例子,当我们从 prop 中获取一些新值,运行 slowFormatText 函数格式化文本属性,但这个缓慢的计算需要大量时间执行

function Button({ text }) {
const [formattedText] = useState(() => slowlyFormatText(text));

return <button>{formattedText}</button>;
}

下面改进:让其处于 state,解决不必要重新运行,但同上都停止了组件更新。更好的方法是使用 useMemo hook 来记住结果,slowlyFormatText 仅在 text 更改时才运行且没有停止组件更新

function Button({ text }) {
const formattedText = useMemo(() => slowlyFormatText(text), [text]);

return <button>{formattedText}</button>;
}


注:有时我们确实需要一个 prop,在它身上所有更新都被忽略。例如颜色选择器,需要该选项设置初始选择颜色,但当用户选择一种颜色时,我们不希望更新覆盖用户的选择,这种情况可以将 prop 复制到 state,但为了引导用户,大多数人都会在 prop 前面加上初始默认值
弹性组件


四、从函数返回 JSX

不要从组件内部的函数返回 JSX

function Component() {
const topSection = () => {
return (
<header>
<h1>Component header</h1>
</header>
);
};

const middleSection = () => {
return (
<main>
<p>Some text</p>
</main>
);
};

const bottomSection = () => {
return (
<footer>
<p>Some footer text</p>
</footer>
);
};

return (
<div>
{topSection()}
{middleSection()}
{bottomSection()}
</div>
);
}

乍一看还可以,但代码难推理,应避免使用。可以内联 JSX
注:因为创建了新组件,所以不必将其移动到新文件中。有时如果多个组件紧密耦合,则将它们保留在同一个文件中时有意义的。


五、state 中的多个 booleans

要避免使用多个布尔值表示组件的状态, 尤其时编写组件的后续拓展组件功能时,容易出现多个布尔值来表示组件状态。
例:单击按钮发出 web 请求的小型组件

function Component() {
const [isLoading, setIsLoading] = useState(false);
const [isFinished, setIsFinished] = useState(false);
const [hasError, setHasError] = useState(false);

const fetchSomething = () => {
setIsLoading(true);

fetch(url)
.then(() => {
setIsLoading(false);
setIsFinished(true);
})
.catch(() => {
setHasError(true);
});
};

if (isLoading) return <Loader />;
if (hasError) return <Error />;
if (isFinished) return <Success />;

return <button onClick={fetchSomething} />;
}

单击按钮时,将 isLoading 设置为 true 并用 fetch 发起 web 请求,请求成功时,则将 isLoading 设置为 false 并将 isFinished 设置为 true,否则将 hasError 设置为 true;
能用,但是难推断组件状态,易出错。可能最终出现不可能的状态,比如意外将 isLoading 和 isFinished 同时设置为 true;
枚举,最好能管理状态的方法。其他语言中,它是一种定义变量的方法,该变量只能设置为预定义的常量值集合,技术上来说,枚举在 js 中不存在,可使用字符串作为枚举

function Component() {
const [state, setState] = useState("idle");

const fetchSomething = () => {
setState("loading");

fetch(url)
.then(() => {
setState("finished");
})
.catch(() => {
setState("error");
});
};

if (state === "loading") return <Loader />;
if (state === "error") return <Error />;
if (state === "finished") return <Success />;

return <button onClick={fetchSomething} />;
}

消除了不可能状态的可能性,并且更具有推理性;若并入 TS 的类型系统:

const [state, setState] =
(useState < "idle") | "loading" | "error" | ("finished" > "idle");


六、useState 太多

避免在同一组件使用太多 useState hooks
有太多 useState hooks 的组件内部功能太多,需要分解成多个组件,但是在某些复杂情况下,需要单个组件中管理某些复杂状态
例:自动完成输入组件中的某些状态和几个功能

function AutocompleteInput() {
const [isOpen, setIsOpen] = useState(false)
const [inputValue, setInputValue] = useState('')
const [items, setItems] = useState([])
const [selectedItem, setSelectedItem] = useState(null)
const [activeIndex, setActiveIndex] = useState(-1)

const reset = () => {
setIsOpen(false)
setInputValue('')
setItems([])
setSelectedItem(null)
setActiveIndex(-1)
}

const selectItem = (item) => {
setIsOpen(false)
setInputValue(item.name)
setSelectedItem(item)
}

...
}

一个重置功能函数重置所有状态,一个 selectItem 函数来更新某些状态,这些函数必须使用 useState 中的许多状态设置器来完成预期任务。以后我们可能还需要操作更多,维护会越来越困难。
useReducer hook 来代替管理状态:

const initialState = {
isOpen: false,
inputValue: "",
items: [],
selectedItem: null,
activeIndex: -1
}
function reducer(state, action) {
switch (action.type) {
case "reset":
return {
...initialState
}
case "selectItem":
return {
...state,
isOpen: false,
inputValue: action.payload.name,
selectedItem: action.payload
}
default:
throw Error()
}
}

function AutocompleteInput() {
const [state, dispatch] = useReducer(reducer, initialState)

const reset = () => {
dispatch({ type: 'reset' })
}

const selectItem = (item) => {
dispatch({ type: 'selectItem', payload: item })
}

...
}

使用简化器,封装管理状态的逻辑,将复杂性移出组件。现在可以分别考虑状态和组件,便于理解。

注:useState 和 useReducer 都具有各自的优缺点和不同的用例。减速器推荐:状态减速器模式


七、大量 useEffect

避免使用大量 useEffect 产生多种影响,易出错,难推理。 当释放钩子的时候,错误做法就是将太多的东西放到一个 useEffect 中。

function Post({ id, unlisted }) {
...
useEffect(() => {
fetch(`/posts/${id}`).then(' do something ')

setVisibility(unlisted)
}, [id, unlisted])
...
}

虽然效果不太大,但它仍可做很多事,当私有 prop 变化时,即使 id 不变,我们也可 fetch post
为了捕捉此类错误,通过 依赖项更改时来执行此操作来描述效果。当 id 或未更改,fetch post 更新可见
若包含 or 或 and,则表示存在问题,下面拆分成两个 useEffect

function Post({ id, unlisted }) {
...

useEffect(() => { // when id changes fetch the post
fetch(`/posts/${id}`).then('...')
}, [id])

useEffect(() => { // when unlisted changes update visibility
setVisibility(unlisted)
}, [unlisted])

...
}

可以降低组件复杂性,易推理,降低创建错误的风险

来自:https://yolkpie.github.io/2022/05/06/react-component-code-smells/

链接: https://fly63.com/article/detial/11470

Vuetify基于vue2.0,为移动而生的组件框架

Vuetify 支持SSR(服务端渲染),SPA(单页应用程序),PWA(渐进式Web应用程序)和标准HTML页面。 Vuetify是一个渐进式的框架,试图推动前端开发发展到一个新的水平。

Vue中插槽的作用_Vue组件插槽的使用以及调用组件内的方法

通过给组件传递参数, 可以让组件变得更加可扩展, 组件内使用props接收参数,slot的使用就像它的名字一样, 在组件内定义一块空间。在组件外, 我们可以往插槽里填入任何元素。slot-scope的作用就是把组件内的数据带出来

react 函数子组件(Function ad Child Component)

函数子组件(FaCC )与高阶组件做的事情很相似, 都是对原来的组件进行了加强,类似装饰者。FaCC,利用了react中children可以是任何元素,包括函数的特性,那么到底是如何进行增强呢?

Vue和React组件之间的传值方式

在现代的三大框架中,其中两个Vue和React框架,组件间传值方式有哪些?组件间的传值是灵活的,可以有多种途径,父子组件同样可以使用EventBus,Vuex或者Redux

vue.js自定义组件directives

自定义指令:以v开头,如:v-mybind。bind的作用是定义一个在绑定时执行一次的初始化动作,观察bind函数,它将指令绑定的DOM作为一个参数,在函数体中,直接操作DOM节点为input赋值。

vue中prop属性传值解析

prop的定义:在没有状态管理机制的时候,prop属性是组件之间主要的通信方式,prop属性其实是一个对象,在这个对象里可以定义一些数据,而这些数据可以通过父组件传递给子组件。 prop属性中可以定义属性的类型,也可以定义属性的初始值。

Web组件简介

Web组件由三个独立的技术组成:自定义元素。很简单,这些是完全有效的HTML元素,包含使用一组JavaScript API制作的自定义模板,行为和标记名称(例如,<one-dialog>)。

web组件调用其他web资源

web组件可以直接或间接的调用其他web资源。一个web组件通过内嵌返回客户端内容的另一个web资源的url来间接调用其他web资源。在执行时,一个web资源通过包含另一个资源的内容或者转发请求到另一个资源直接调用。

vue中如何实现的自定义按钮

在实际开发项目中,有时我们会用到自定义按钮;因为一个项目中,众多的页面,为了统一风格,我们会重复用到很多相同或相似的按钮,这时候,自定义按钮组件就派上了大用场,我们把定义好的按钮组件导出,在全局引用,就可以在其他组件随意使用啦,这样可以大幅度的提高我们的工作效率。

Vue子组件调用父组件的方法

Vue中子组件调用父组件的方法,这里有三种方法提供参考,第一种方法是直接在子组件中通过this.$parent.event来调用父组件的方法,第二种方法是在子组件里用$emit向父组件触发一个事件,父组件监听这个事件就行了。

点击更多...

内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!