Thêm React vào dự án có sẵn
Nếu bạn muốn thêm một số tính năng vào dự án hiện tại của mình, bạn không cần phải viết lại dự án đó bằng React. Thêm React vào stack công nghệ của bạn, và hiển thị các component của React ở bất kì đâu.
Sử dụng React cho một đường dẫn của trang web của bạn
Giả sử bạn có một ứng dụng web tại example.com được phát triển với một công nghệ khác (như Rails), và bạn muốn triển khai tất cả các đường dẫn bắt đầu bằng. example.com/some-app/ hoàn toàn với React.
Đây là cách chúng tôi đề xuất để cài đặt:
- Xây dựng phần React của ứng dụng của bạn sử dụng một trong những nền tảng ứng dụng (framework) sử dụng React.
- Chỉ định
/some-applà đường dẫn gốc trong cấu hình ứng dụng của bạn. (xem hướng dẫn với: Next.js, Gatsby). - Cấu hình máy chủ của bạn hoặc một proxy để tất cả các requests ở
/some-app/được xử lý bởi ứng dụng React của bạn.
Điều này đảm bảo phần React của ứng dụng của bạn có thể được hưởng lợi từ các tiêu chuẩn tốt nhất đã được tích hợp sẵn trong các Frameworks đó.
Nhiều frameworks dựa trên React là full-stack và cho phép ứng dụng React của bạn tận dụng các tính năng của máy chủ. Tuy nhiên, bạn có thể sử dụng cùng một phương pháp ngay cả khi bạn không thể hoặc không muốn chạy JavaScript trên máy chủ. Trong trường hợp đó, hãy chuẩn bị HTML/CSS/JS export (next export output cho Next.js, mặc định cho Gatsby) tại /some-app/.
Sử dụng React cho một phần của trang web của bạn
Giả sử bạn đã có một trang web được xây dựng bằng một công nghệ khác (có thể là công nghệ phía server như Rails, hoặc công nghệ phía client như Backbone), và bạn muốn hiển thị các component React tương tác ở một số nơi trên trang đó. Đó là một cách thông thường để tích hợp React - thực tế, đó là cách mà hầu hết các ứng dụng React được sử dụng tại Meta trong nhiều năm qua!
Bạn có thể làm điều này trong hai bước:
- Thiết lập môi trường JavaScript cho phép bạn sử dụng cú pháp JSX, chia code của bạn thành các module với cú pháp
import/export, và sử dụng các package (ví dụ như React) từ npm package registry. - Render các component React của bạn tại nơi bạn muốn xem chúng trên trang web.
Cách tiếp cận cụ thể phụ thuộc vào thiết lập trang web hiện tại của bạn, vì vậy hãy cùng đi vào chi tiết.
Bước 1: Thiết lập môi trường JavaScript module hóa
Môi trường JavaScript module hóa cho phép bạn viết các component React của mình trong các tệp riêng lẻ, thay vì viết toàn bộ mã của bạn trong một tệp duy nhất. Nó cũng cho phép bạn sử dụng tất cả các package tuyệt vời bởi các nhà phát triển khác trên npm registry—bao gồm cả chính React! Cách thực hiện điều này phụ thuộc vào cài đặt hiện có của bạn:
-
Nếu ứng dụng của bạn đã được chia thành các tệp sử dụng các câu lệnh
import, hãy cố gắng sử dụng thiết lập hiện có của bạn. Kiểm tra xem viết<div />trong mã JS có gây lỗi cú pháp không. Nếu nó gây ra lỗi cú pháp, bạn có thể cần chuyển đổi mã JavaScript của mình bằng Babel, và kích hoạt Babel React preset để sử dụng JSX. -
Nếu ứng dụng của bạn không có cài đặt cho việc biên dịch các module JavaScript, hãy cài đặt với Vite. Cộng động Vite duy trì nhiều tích hợp với các framework back-end, bao gồm Rails, Django, và Laravel. Nếu framework backend của bạn không được liệt kê, hãy làm theo hướng dẫn này để tích hợp Vite với backend của bạn bằng cách thủ công.
Để kiểm tra xem thiết lập của bạn hoạt động, chạy lệnh này trong thư mục dự án của bạn:
Sau đó thêm những dòng code này vào đầu của file JavaScript chính của bạn (đó có thể là index.js hoặc main.js):
import { createRoot } from 'react-dom/client'; // Xoá đi những nội dung HTML tồn tại trước đó document.body.innerHTML = '<div id="app"></div>'; // Render component React của bạn const root = createRoot(document.getElementById('app')); root.render(<h1>Hello, world</h1>);
Nếu toàn bộ nội dung của trang web của bạn đã bị thay thế bằng một dòng chữ “Hello, world”, điều đó có nghĩa là mọi thứ đã hoạt động! Hãy tiếp tục đọc.
Bước 2: Render các component React bất kỳ nơi nào trên trang
Trong bước trước đó, bạn đã đưa code này lên đầu tệp chính của mình:
import { createRoot } from 'react-dom/client';
// Clear the existing HTML content
document.body.innerHTML = '<div id="app"></div>';
// Render your React component instead
const root = createRoot(document.getElementById('app'));
root.render(<h1>Hello, world</h1>);Tất nhiên, bạn không muốn xóa toàn bộ nội dung HTML hiện có của mình!
Hãy xoá đoạn code này.
Thay vào đó, bạn sẽ muốn render các component React ở những nơi cụ thể trong HTML của mình. Hãy mở trang HTML của bạn (hoặc template server nào đó đã sinh ra chúng) và thêm vào thuộc tính id độc nhất cho bất kì thẻ HTML nào, ví dụ như:
<!-- ... đâu đó trong html của bạn ... -->
<nav id="navigation"></nav>
<!-- ... thêm html ... -->Điều này sẽ giúp bạn tìm kiếm phần tử HTML với document.getElementById và truyền vào createRoot để bạn có thể render component React bên trong:
import { createRoot } from 'react-dom/client'; function NavigationBar() { // TODO: Actually implement a navigation bar return <h1>Xin chào từ React!</h1>; } const domNode = document.getElementById('navigation'); const root = createRoot(domNode); root.render(<NavigationBar />);
Chú ý là nội dung HTML ban đầu từ index.html được giữ nguyên, nhưng component NavigationBar React của bạn giờ đây hiển thị bên trong <nav id="navigation"> từ trong HTML của bạn. Hãy đọc tài liệu sử dụng createRoot để tìm hiểu thêm về cách hiển thị các component React trong một trang HTML hiện có.
Khi bạn sử dụng React với một dự án tồn tại trước đó, thường thì bạn sẽ bắt đầu với những component tương tác nhỏ (như nút bấm), và sau đó dần dần “tiến lên trước” cho tới khi toàn bộ trang web của bạn được xây dựng bằng React. Khi bạn đạt đến đó, chúng tôi khuyến nghị hãy chuyển đổi sang một React framework ngay sau đó để có thể sử dụng tối ưu React.
Sử dụng React Native trong một ứng dụng di động native hiện có
React Native cũng có thể được tích hợp vào các ứng dụng native hiện có một cách từ từ và tăng dần. Nếu bạn có một ứng dụng native hiện có cho Android (Java hoặc Kotlin) hoặc iOS (Objective-C hoặc Swift), hãy làm theo hướng dẫn này để thêm một màn hình React Native vào ứng dụng của bạn.